curl --request GET \
  --url https://{tenant_name}.{region}.techwolf.ai/employees/{employee_external_id}/vacancies/{vacancy_external_id}/recommended_courses \
  --header 'Authorization: Bearer <token>'
[
  {
    "external_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7",
    "course_title": "Computer Science 101",
    "course_description": "This Professional Certificate will start you at the absolute beginning teaching you about the fundamental binary language of modern computers. You’ll learn about the Turing Machine—a model for the digital computer. You’ll also learn the basics of analytic logic and how learning and applying basic principles of logic can help you both work with and work on technical solutions. You’ll work in a managed environment and learn to code your very first program in Python – a powerful but simple programming language used by app developers and data scientists.",
    "source": "Udemy",
    "active": true,
    "relevant_skills": [
      "Python",
      "Django"
    ]
  }
]

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
employee_external_id
string
required

Unique external ID linked to this Employee, consisting of alphanumeric characters, hyphens and underscores.

Required string length: 1 - 100
Example:

"a3903505-eb84-42dc-a79f-5e7b1fe897b7"

​
vacancy_external_id
string
required

Unique external ID linked to this Vacancy, consisting of alphanumeric characters, hyphens and underscores.

Required string length: 1 - 100
Example:

"a3903505-eb84-42dc-a79f-5e7b1fe897b7"

Query Parameters

​
limit
integer
default:10

The maximal number of results returned.

Required range: 1 <= x <= 100
Example:

10

​
show_skills
boolean
default:false

If true, the relevant Skills you can learn in each recommended Course are provided.

Example:

true

Response

200
application/json

OK

​
external_id
string
required

The unique ID in your system, consisting of alphanumeric characters, hyphens and underscores.

Required string length: 1 - 100
Example:

"a3903505-eb84-42dc-a79f-5e7b1fe897b7"

​
course_title
string
required

Title of the Course.

Required string length: 1 - 255
Example:

"Computer Science 101"

​
course_description
string
required

Textual description of the Course.

Minimum length: 1
Example:

"This Professional Certificate will start you at the absolute beginning teaching you about the fundamental binary language of modern computers. You’ll learn about the Turing Machine—a model for the digital computer. You’ll also learn the basics of analytic logic and how learning and applying basic principles of logic can help you both work with and work on technical solutions. You’ll work in a managed environment and learn to code your very first program in Python – a powerful but simple programming language used by app developers and data scientists."

​
relevant_skills
string[]

A list of Skills that the Course provides that are relevant for the Skill Profile of the Employee.

Example:
["Python", "Django"]
​
source
string

Source system or location of this Course.

Required string length: 1 - 255
Example:

"Udemy"

​
active
boolean | null
default:true

The Course will not be used in matching if active is false. This is useful when a Course is being phased out.

Example:

true